home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / txt2m20.zip / TXT2MSG.DOC < prev    next >
Text File  |  1992-01-12  |  5KB  |  118 lines
  1.  
  2.                                 Txt2Msg v2.0
  3.                                Copyright 1991
  4.                              by Randy Blackmond
  5.                              All Rights Reserved
  6.  
  7.      Txt2Msg allows you to post any text file (100 lines or less) as a
  8.      message to your RemoteAccess message base... from the DOS commandline! 
  9.  
  10.      The syntax of Txt2Msg is:
  11.  
  12.      TXT2MSG <textfilename> <boardnumber> [FirstName] [LastName] 
  13.              [P] [C] [Zone:Net/Node] [ONLINE ExitPath]
  14.  
  15.      Only the first 4 parameters are order sensitive. The P, C, address
  16.      and 'ONLINE ExitPath' parameters can be in any order after the 
  17.      previous parameters.
  18.  
  19.      So, if you wanted to post the file THISTEXT.MSG to board 5 of your
  20.      message base as a private message, you would type:
  21.  
  22.      TXT2MSG THISTEXT.MSG 5 P
  23.  
  24.      If you include a name, first and last, on the commandline, the message
  25.      will be addressed to that individual. Otherwise, the To information is
  26.      looked for in the text file.
  27.  
  28.      A 'Zone:Net/Node' parameter means to send this message to that node.
  29.      This is only applicable if the message board is a NetMail board. The
  30.      Origin address is taken from the message board's address information.
  31.  
  32.      A 'C' on the commandline means to make the message "Crash". This is
  33.      only applicable if the message board is a NetMail board.
  34.  
  35.      A 'P' on the commandline means make the message private. Without the 
  36.      'P', the message would be posted as public.
  37.  
  38.      To enter a crash net message on a netmail board 3 to Joe Blow at 
  39.      1:999/99, you would type:
  40.  
  41.      TXT2MSG NETMSG.TXT 3 Joe Blow 1:999/99 P C
  42.      
  43.      Echo messages are also supported. If you import a message to an
  44.      EchoMail board, the tear line and Origin line configured for the message 
  45.      board (or the system default if none are configured) is automatically 
  46.      appended to the bottom of the message.
  47.  
  48.      The top of the text file is where Txt2Msg expects to find the From, 
  49.      Subject and optionally the To information for the message. Line 1 is 
  50.      who the message is from. If the To name is specified in the command 
  51.      line, then line 2 is the subject, otherwise line 2 is the To name and 
  52.      line 3 is the subject.
  53.  
  54.      The only other requirement is that your RA environment variable be
  55.      set. This is how Txt2Msg locates your RA system files.
  56.      
  57.      The 'ONLINE ExitPath' parameter can be used if you plan to execute 
  58.      Txt2Msg to enter a message to a user online via a door or textfile shell.
  59.      The ExitPath is the path to the DORINFO1.DEF and EXITINFO.BBS files.
  60.      When this parameter is used, it enables the use of some of RA's text
  61.      file control codes in your message text file. The codes currently 
  62.      supported are listed below. If you have a particular need for any codes
  63.      that are not currently supported, register the program and I'll add them
  64.      for you!
  65.  
  66.      ^FA - User's Full Name
  67.      ^FW - User's First Name
  68.      ^FO - User's Security Level
  69.      ^F6 - User's Subscription Expiration Date
  70.      ^F7 - Days until User's Subscription Expiration
  71.      ^KJ - Today's Date
  72.  
  73.      A good application for this might be to enter a message to a new user.
  74.      By inserting a text shell command in the NEWUSER.A* files, you can
  75.      send a message to the user and he will be notified that he has mail
  76.      waiting when he gets to the message scan!
  77.  
  78.      Example:
  79.  
  80.        The text file command line:
  81.          ^XTXT2MSG.EXE NEWUSER.MSG 1 *F *L P ONLINE C:\RA|
  82.        OR
  83.          ^XTXT2MSG.EXE NEWUSER.MSG 1 P ONLINE C:\RA|
  84.          and place ^FA on the 2nd line of the text file!
  85.  
  86.      CREDITS
  87.      -------
  88.      This door was written in Turbo Pascal 6.0 by Borland International
  89.      and uses the JPDoor 3.1 RA toolkit - Copyright 1991 by Rod Hancock
  90.  
  91.      SUPPORT
  92.      -------
  93.      If you have suggestions or bug reports, I can be contacted by several
  94.      methods. 1) Send FIDO Netmail to me at 1:381/70, 2) Send FIDO echo
  95.      mail to me in the RA_UTILS or SHAREWRE echos, 3) Call my board at
  96.      505-589-0319 USR DS and leave a Comment, 4) Send RIME echo mail to me
  97.      in the RIME RemoteAccess conference or 5) Call me by voice at
  98.      505-589-0317 and leave a message on my answering machine.
  99.  
  100.      DISCLAIMER
  101.      ----------
  102.      No warranties, either expressed or implied, are given with this program.
  103.      I, Randy Blackmond, will not be held responsible for any damage that
  104.      may occur by use of this program. USE AT YOUR OWN RISK!
  105.      
  106.      REGISTRATION
  107.      ------------
  108.      Txt2Msg is a shareware program. Please see the included REGISTER.DOC 
  109.      for registration instructions.
  110.  
  111.      OTHER RA PRODUCTS
  112.      -----------------
  113.      RAMail                  - The QWK compatible mail door for RemoteAccess
  114.      CC-TRX Credit Card Door - Allow users to subscribe or purchase items
  115.                                items online with their credit cards!
  116.  
  117.  
  118.